home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / bbs_door / ivb100.zip / SYSOP.DOC < prev   
Text File  |  1996-05-30  |  22KB  |  525 lines
  1. Digital Genesis - (608)781-9660  - (1:2360/13)
  2.  
  3. Digital Genesis Software presents...                              (05/30/96)
  4.  
  5.                            InterLink Voting Booth v1.0.0
  6.  
  7.                        Copyright (c) 1995,96 by James Sella
  8.                                 All rights reserved.
  9.  
  10. NOTE: InterLink Voting Booth currently supports only 'dorinfo1.def' that is
  11.       compatible with RA and 'door.sys'. Use a conversion program as
  12.       need be.
  13.  
  14. I always throw this in on the top so you see it.. Registration is $15.
  15. There is more info at the bottom of this doc about registration. Registered
  16. users of Dream Voting Booth will want to read the reg. section as well.
  17.  
  18. ***Disclaimer:
  19.       This software, it's associated files and documentation is provided
  20.       "as is" without warranty of any kind, either expressed or implied.
  21.       The author, or anyone else involved with this program shall not be
  22.       liable for any direct, indirect, consequential or incidental damages,
  23.       including loss of profits, interruption of business, loss of
  24.       information, or any other claims, attributed to the use, or inability
  25.       to use this software. This software is guarantied to do nothing more
  26.       than take up drive space.
  27.  
  28.       (ie: If you dog dies after you use this software, it is not my fault.)
  29.  
  30. ***License:
  31.       This software is NOT freeware, it is shareware. You are given a chance
  32.       to try out this software before you buy it. If you have no intention of
  33.       registering this software please discontinue use of it. This software
  34.       may be copied as long as the original archive stays intact. This
  35.       software may NOT be sold or placed in any package without direct written
  36.       permission from the author. (Those making CD-Roms, please ask!)
  37.  
  38.  
  39. Installing the software: 
  40.  
  41. -Unarchive the distribution archive into it's own unique directory.
  42.  
  43. -Run Install.com.
  44.  
  45.         Install will create the directories DATA, PICS, OUTBOUND, and LOG. It
  46.         will then move all files to the correct directories.
  47.  
  48.         Make sure to answer the question correctly. If you goof up, you will
  49.         have to run the program over again.
  50.  
  51.         Choose to be HUB only if you are the site running the league.. that's
  52.         what the HUB is!
  53.  
  54.         If you don't have a league to join, contact James Sella at 1:2360/13
  55.         and I can enter you into league 1, since I am HUB for it. :)
  56.  
  57. -Customize IVB for your BBS. [Optional]
  58.  
  59.         At this point, you may want to customize IVB for your setup.
  60.         You won't have to, as Install.com did the required field for you.
  61.  
  62.         (Many of you will find something that annoys you in IVB. That's why
  63.         many of these options are in here. Make it like you want it.)
  64.  
  65.         NOTE: The format for each is listed later in the docs.
  66.  
  67.         BBS.cfg
  68.                 - Basic info on your BBS.
  69.         IVB.ctl
  70.                 - Basic info about InterLink Voting Booth.
  71.         IVB1.cfg
  72.                 - Node 1's config file. Info on Node 1's dropfile location.
  73.                   Each Node will have it's own IVB#.cfg file.
  74.         ROUTE.ctl
  75.                 - Basically tells IVB which BBS's you will send packets to.
  76.                   It is probably already correct for you!
  77.         BADUSERS.dat
  78.                 - List of Users that are not allowed into IVB.
  79.         BADWORDS.dat
  80.                 - List of "Bad Words". Allows SysOp to pick and choose words
  81.                   they do and do not want displayed to their users.
  82.         IVBNLIST.xxx
  83.                 - Nodelist for IVB.
  84.  
  85. -BBS Setup
  86.  
  87.        -First, I would suggest making a batch file to run the door. Here are
  88.         two examples.
  89.  
  90.                 ;Sample for Single Node BBS
  91.                 c:
  92.                 cd\bbs\ivb
  93.                 IVBMAINT.exe INBOUND
  94.                 IVB.exe ivb1.cfg
  95.                 IVBMAINT.exe OUTBOUND
  96.                 cd\bbs
  97.  
  98.                 ;Sample for Multiple Node BBS
  99.                 c:
  100.                 cd\bbs\ivb
  101.                 IVBMAINT.exe INBOUND
  102.                 IVB.exe ivb%1.cfg
  103.                 IVBMAINT.exe OUTBOUND
  104.                 cd\bbs
  105.  
  106.         NOTE: You can take IVBMAINT out of these batch files if you would
  107.               rather do this in an event.
  108.  
  109.        -Second, set up your BBS to call the batch file. For RemoteAccess make
  110.         a "Execute sub-program (Type 7)".
  111.  
  112.         An example of what to put in the OptData field:
  113.  
  114.                 *C /c c:\bbs\ivb\ivb.bat *N*M
  115.  
  116.         You will need to change the path to the batch file to fit your system.
  117.         (I guess that's why this is called an example.)
  118.  
  119.         The "*C /c" tells RA to load Command.com and execute a batch file.
  120.         The "*N" will pass the node number to the batch file and "*M" will
  121.         swap the BBS out of memory. (Refer to RA.doc for detailed help.)
  122.  
  123.         If you are not running RA, you will need to check the docs for your
  124.         BBS software for help on this one.
  125.  
  126.        -Third, you will want to run IVBMaint.exe on your nightly event. Make
  127.         sure to run the "IVBMaint.exe MAINT [90]" command. That will remove old
  128.         users (move than 90 days inactive) and remove expired booths.
  129.  
  130. Additional Information:
  131.  
  132. -Running IVB 
  133.  
  134.         General information on use of IVB is included in the file IVB_HELP.txt.
  135.         which is the online help for users. Feel free to edit IVB_HELP.txt for
  136.         your users. (Something it's missing? Let me know.)
  137.  
  138.         NOTE: Have ANSI.sys or ANSI.com loaded. It looks really messy without.
  139.  
  140. -Command Line Options
  141.  
  142.         IVB has several command line options. (Anything you want added?)
  143.  
  144.         Here is the basic format:
  145.  
  146.                 IVB.exe <IVB#.cfg> [-Local] [-S<1-5>]
  147.  
  148.                 ie: IVB.exe IVB1.cfg
  149.                 ie: IVB.exe IVB0.cfg -Local
  150.                 ie: IVB.exe IVB2.cfg -S5
  151.                 ie: IVB.exe IVB9.cfg -L -S3
  152.  
  153.         -L or -Local:
  154.  
  155.                 This option allows the SysOp to enter the door without a
  156.                 dropfile. IVB will ask you for a username.
  157.  
  158.         -S<1-5>:
  159.  
  160.                 This option is for SysOps that want to ask the user to vote
  161.                 as they log onto the BBS.
  162.  
  163.                 -S1 only tells the user if they have or have not voted on the
  164.                     available booths. It does NOT give them a choice to vote
  165.                     on them. It waits for the user to press a key to continue.
  166.  
  167.                 -S2 tells the user if they have or have not voted on the
  168.                     available booths. It will give them the choice to vote on
  169.                     the booths. The default answer for -S2 is No. This option
  170.                     will also exit with errorlevel -1 if they choose No.
  171.  
  172.                 -S3 is exactly the same as -S2, but the default choice is Yes.
  173.  
  174.                 -S4 tells the user if they have or have not voted on all
  175.                     available booths and will load IVB regardless.
  176.  
  177.                 -S5 checks how many booths the user has voted on and returns
  178.                     that negative value. (ie: Joe didn't vote on 5 booths, so
  179.                     IVB returns -5 as the errorlevel.) If the user has voted
  180.                     on all available booths, IVB returns 0 as normal. This
  181.                     option displays nothing to the user.
  182.  
  183.                     You are probably thinking "What the H*LL would I use this
  184.                     for?!" Well, you can use it for what ever you want. One
  185.                     SysOp wanted to use it so he could remove 1 min for each
  186.                     booth not voted on. He passed the errorlevel to a RA Util
  187.                     that could remove or add time to a user that was online.
  188.  
  189.         IVBMaint has several command line options.
  190.  
  191.         Here is the basic format:
  192.  
  193.                 IVBMAINT.exe <keyword> [optional keyword]
  194.  
  195.                 ie: IVBMAINT.exe INBOUND
  196.                 ie: IVBMAINT.exe MAINT 31
  197.                 ie: IVBMAINT.exe EXPIRE
  198.                 ie: IVBMAINT.exe ADD 4
  199.  
  200.         -RESET (HUB only)
  201.                 This command will reset your entire league. Only the HUB can
  202.                 execute this command.
  203.  
  204.         -SYNC
  205.                 Attempts to sync your copy of IVB to the rest of the league.
  206.                 Basically, it finds new nodelists and network control files.
  207.  
  208.         -FULL
  209.                 Executes INBOUND and OUTBOUND in one action.
  210.  
  211.         -MAINT [31]
  212.                 Executes PURGE and EXPIRE in one action. 31 days is the
  213.                 default time limit.
  214.  
  215.         -INBOUND
  216.                 Finds all inbound packets (including nodelists and network
  217.                 control files) and processes them.
  218.  
  219.         -OUTBOUND
  220.                 Creates new outbound packets when needed.                
  221.  
  222.         -COMPILE
  223.                 Manually compiles the newest nodelist in the IVB directory.
  224.                 It locates the newest nodelist by checking the files date.
  225.  
  226.         -PURGE [31]
  227.                 Purges user that have been inactive for specified days. It
  228.                 will remove them from the local database and will remove
  229.                 their votes from the entire league. 31 days is the default
  230.                 time limit.
  231.  
  232.         -EXPIRE
  233.                 Removes local booths that have passed their expiration date.
  234.  
  235.         -USER [username]
  236.                 Removes specified user from the local database and will remove
  237.                 their votes from the network.
  238.  
  239.         -ADD [node number] (HUB only)
  240.                 Sends current database to specified node. When this node
  241.                 receives the database, their user records will be restarted
  242.                 and they will be set exactly as the HUB.
  243.  
  244.                 NOTE: If you are adding someone for the first time, make
  245.                       sure you have entered them into a new IVB nodelist
  246.                       and compiled the nodelist before running this command.
  247.  
  248.                 HINT: If one of the SysOps in your league looses their
  249.                       database due to crash or corruption, use the ADD
  250.                       command on them. It will restore them. (They will
  251.                       again have all of the booths, users will loose their
  252.                       vote unfortunately.)
  253.                       the ADD command on his node. It should 
  254.                 
  255.  
  256. -File Format
  257.  
  258. NOTE: Example.arj contains sample files with discriptions included.
  259.  
  260. FILE: BBS.cfg (All directories in BBS.cfg must have a drive letter.)
  261.  
  262. Line  Example                 Description
  263. -----------------------------------------------------------------------------
  264. 01    James Sella             SysOp Name
  265. 02    Digital Genesis         BBS Name
  266. 03    1:2360/13               BBS Address
  267. 04    c:\bbs\ivb              Location of IVB (Program Directory)
  268. 05    c:\bbs\inbound          Location of Inbound Packets (Inbound Directory)
  269. 06    c:\bbs\netmail          Location of NetMail Directory
  270. 07    c:\dos                  Location of ARJ or ZIP (Utility Directory)
  271. 08    ZIP                     Archive Utility used by League (ZIP or ARJ)
  272. 09    1                       League Number (Any number from 1 to 999)
  273. 10    FRONTDOOR               Mailer (FRONTDOOR or INTERMAIL)
  274.  
  275. FILE: IVB.ctl (With the 'Minimum Level' options, 0 will allow any security)
  276.  
  277. Line  Example                 Description
  278. -----------------------------------------------------------------------------
  279. 01    James Sella             SysOp Name
  280. 02    Digital Genesis         BBS Name
  281. 03    0123456789              Reg Code
  282. 04    YES                     Use IN_USE.flg (YES or NO)
  283. 05    YES                     Use Logo (YES or NO)
  284. 06    YES                     Use Graphs (YES or NO)
  285. 07    205                     Ascii Value of graph character  ie: 205 is ═
  286. 08    254                     Ascii Value of censoring character ie: 254 is ■
  287. 09    YES                     Allow Use of Variables (@USERNAME@, @FIRSTNAME@, @LOCATION@)
  288. 10    YES                     Allow Results of Booths NOT Voted On
  289. 11    WINDOWS                 Multitasker (NONE, WINDOWS, OS2, DESQVIEW)
  290. 12    100                     SysOp level
  291. 13    60                      Min per day
  292. 14    99                      Max times in door.
  293. 15    3                       Max Add Choices to Booth. (0 = Disable Adding Choices)
  294. 16    0                       Minimum level required to CREATE booths. (0 = Any Level)
  295. 17    0                       Minimum level required to DELETE booths.
  296. 18    0                       Minimum level required to make ANONYMOUS booths.
  297. 19    0                       Minimum level required ADD choices to booth.
  298. 20    0                       Minimum level required to make EXPIRE booths.
  299. 21    Partial                 Bad Word checking type (NONE, PARTIAL, FULL)
  300.  
  301. FILE: IVB#.cfg 
  302.  
  303. Line  Example                 Description
  304. -----------------------------------------------------------------------------
  305. 01    DORINFO1.def            Drop File type. (DORINFO1.def or DOOR.sys)
  306. 02    c:\bbs                  Path to drop file
  307. 03    log\IVB1.log            Path with name of log file for node 0
  308. 04    1                       Node Number
  309.  
  310. FILE: ROUTE.ctl (For a NODE looks like this. This is most people.)
  311.  
  312. Line  Example                 Description
  313. -----------------------------------------------------------------------------
  314. 01    1                       Route to node 1
  315.                                              
  316. FILE: ROUTE.ctl (For a HUB looks like this.)
  317.  
  318. Line  Example                 Description
  319. -----------------------------------------------------------------------------
  320. 01    2                       Route to node 2
  321. 02    3                       Route to node 3
  322. 03    4                       Route to node 4
  323. 04    5                       Route to node 5
  324. 05    6                       Route to node 6
  325.   ...it can go on and on and on forever...
  326. (Yes, this is a bad format.. it will change)
  327.  
  328. NOTE: This file can really goof up IVB if you make incorrect changes to it! 
  329.  
  330. FILE: BADUSERS.dat (The users names in this file ARE case sensitive)
  331.  
  332. Line  Example                 Description
  333. -----------------------------------------------------------------------------
  334. 01    Joe Blow                First User to be locked out.
  335. 02    JOE COOL                Second User
  336. 03    GRAVIS                  Third User
  337.  
  338. NOTE: Make sure to use the name that is being passed to IVB. If you are
  339.       passing handles to IVB, then enter the handle in here. (HINT: Use the
  340.       username that you see on the top of the screen when IVB is running and
  341.       remember the username is case sensitive!)
  342.  
  343. FILE: BADWORDS.dat (Bad Words are NOT case sensitive)
  344.  
  345. Line  Example                 Description
  346. -----------------------------------------------------------------------------
  347. 01    Jerk                    First Bad Word
  348. 02    Moron                   Second Bad Word
  349. 03    Melon                   Third Bad Word
  350.  
  351. NOTE: You may list up to 50 'Colorful' Words.
  352.  
  353. FILE: IVBNLIST.xxx (ie: IVBNLIST.104)
  354.  
  355. Line  Example                 Description
  356. -----------------------------------------------------------------------------
  357. 01    1                       Node number
  358. 02    Digital Genesis         BBS Name
  359. 03    1:2360/13               Address
  360. 04    LaCrosse, Wi USA        Location
  361. 05                            A Blank Line
  362. 06    2                       Node Number
  363. 07    Lizard's Loft           BBS Name
  364. 08    1:2360/19               Address
  365. 09    West Salem, Wi USA      Location
  366. 10                            A Blank Line
  367.  ...Make an entry for each and every bbs in your league...
  368.  
  369. -Joining a league:
  370.  
  371.         If you are searching for a league to join, contact James Sella at
  372.         1:2360/13 and I can add you to league 1.
  373.  
  374. -Beta Sites:
  375.             
  376.         BBS Name: Digital Genesis     BBS Name: Digital Reality
  377.         SysOp   : James Sella         SysOp   : Chris Sheehan
  378.         FidoNet : 1:2360/13           FidoNet : 1:2360/17
  379.         Phone   : (608)781-9660       Phone   : (608)788-0307
  380.         Hours   : 24                  Hours   : 24
  381.         Max Baud: 33.6 (28.8k)        Max Baud: 28.8k
  382.         Modem(s): USR V.34+,Zoom V.FC Modem(s): Zoom V.34,Zoom V.34
  383.         Lines   : 2                   Lines   : 2
  384.         Location: LaCrosse, Wi USA    Location: LaCrosse, Wi USA
  385.  
  386.         BBS Name: Gil's PC
  387.         SysOp   : Gil Dupuis
  388.         FidoNet : 1:12/60
  389.         Phone   : (819)689-4565
  390.         Hours   : 24
  391.         Max Baud: 28.8k
  392.         Modem(s): USR V.Everything
  393.         Lines   : 2
  394.         Location: Chapeau, Qc. Canada
  395.  
  396. -Registration
  397.  
  398. Why would I register?  (At some point you will ask yourself this!)
  399.  
  400.         To help support the development of this product.
  401.         (I had to put this in here.. every other shareware author does!)
  402.  
  403.         The unregistered version has a few limitations.. I tried to keep
  404.         them subtle.
  405.  
  406.         - Short (but very annoying) delay when exiting door. <evil laugh>
  407.  
  408.         - Users can access only first 3 BBS's plus their local BBS.
  409.  
  410.         - Users may only access the first 10 booths of any BBS from an
  411.           unregistered site. (I was going to make this higher but, since you
  412.           can access booths from other BBS's this gives you a total of 30 to
  413.           40 booths to vote on.)
  414.  
  415.         When you register all limitations will be removed. You simply need
  416.         to enter your registration code into the ivb.ctl file.
  417.  
  418. NOTE: Registered user of Dream Voting Booth before 05/31/96, can request a
  419.       free registration up to 09/28/96. (Most already have the code.)
  420.  
  421.       Dream Voting Booth and InterLink Voting Booth will be two separate
  422.       products. Many options were not possible because of the InterBBS
  423.       functionality.. they will be included with Dream Voting Booth v4.0.0.
  424.  
  425. All registrations can be sent to:
  426.  
  427.         Digital Genesis
  428.         c/o - James Sella
  429.         3400 Leonard St.
  430.         LaCrosse, Wi 54601
  431.  
  432. * Please make all checks/money orders payable to: James Sella
  433.  
  434. * Please note that we do NOT have an online registration system at this time.
  435.  
  436. Registration Codes will be returned via NetMail to your BBS (directly, not
  437. routed) or through the U.S. Postal System. Registrations are final and are
  438. not transferable. Please allow 4-6 weeks for delivery.. should take far less
  439. time than that though. :) (Usually, you get them within 24 hours of when I
  440. receive your letter in the mail.) 
  441.  
  442. What is NEEDED for Registrations:
  443.  
  444.         1) SysOp's Real Name
  445.         2) BBS's Name
  446.         3) Name of Program you are Registering
  447.         4) FidoNet Address or Mailing Address
  448.         5) $15 US-Funds (checks/money order payable to James Sella)
  449.  
  450. -Distribution & Support Sites
  451.  
  452. The newest versions of my programs can be FREQed from my BBS or downloaded
  453. from our Web page. (http://cslab.uwlax.edu/~sella_jm/WWW/DG_Soft.html)
  454.  
  455. If unable to FRE'Q from me, please try 1:2360/17 (USA) and 1:2360/12 (Canada).
  456.  
  457. FREQ magic name:
  458.  
  459.         IVB    for InterLink Voting Booth
  460.         DVB    for Dream Voting Booth
  461.         DVB_SP for Dream Voting Booth (Spanish Translation)
  462.         TCALLS for Total Calls ('Who Called?' replacement for RA 2.5)
  463.         AT     for After Thoughts (Message to next caller door)
  464.         UPDATZ for Updatez (Great utility to send text to the remote user)
  465.         FILES  for a full listing of Digital Genesis Software programs.
  466.  
  467. If you would rather call directly, logon as 'Guest'. You won't have to fill
  468. out all of the new user information with this account. (608)781-9660
  469.  
  470. If you would like to contact me in person.
  471.  
  472.         BBS     : 'Gravis' on Digital Genesis at (608)781-9660
  473.         FidoNet : James Sella at (1:2360/13)
  474.         Internet: sella_jm@cowley.uwlax.edu or UltraSella@aol.com
  475.  
  476. -About the program
  477.  
  478. IVB was written in C++ by James Sella over the course of several months..
  479. It almost makes me sick to think about how much time has passed since I have
  480. coded something else!!
  481.  
  482. -Bug Reports
  483.  
  484. If you find a bug, please let me know.. give as detailed of a description as
  485. you possibly can.
  486.  
  487. -Suggestions
  488.  
  489. If you have a suggestion for the next version of IVB, please contact me
  490. concerning this! I can't think of all the ideas you know! :)
  491.  
  492. -History
  493.  
  494. 03/08/95 - Project Started!
  495.  
  496. 05/30/96 - First Public Release of v1.0.0
  497.  
  498. <***End of SysOp.doc***>
  499.  
  500. -P.S.
  501.  
  502. As of course my faithful girlfriend watched me code much of IVB.. I have been
  503. trying to get her to code some doors.. hopefully we will see a door from her
  504. soon. :)
  505.  
  506. And for those of you wondering about the lizards.. We are up to 14 lizard..
  507. we did have more but some of the skinks kicked off. :(
  508.  
  509. The Iguanas (In order of collection):
  510.         Spike  [27"] -Very calm lizard. My first iguana.
  511.         Jerk   [20"] -Actually the biggest.. tail broke, Also the meanest!
  512.         Gleep  [30"] -Vicky's first igauna. Mostly calm w/exceptions. :)
  513.         Spazz  [13"] -Very small and cute (to females at least) Not very calm.
  514. The Water Dragon:
  515.         Baine  [15"] -The only lizard that can eat 3 dozen crickets in 10 sec.
  516. The Agamas:
  517.         Deamon [8"]  -Rather mean.. The pet store forced him on us. This 
  518.                       lizard actually attacks Jerk and wins. :)    
  519.         Mayhem [8"]  -Hey, it's Mayhem. :) Not much to say here.
  520. The Seven Nameless Skinks:
  521.         We never named any of these guys with the exception of Stumpy. He was
  522.         missing his tail when we got him. Stumpy was one that kicked off. :(
  523.  
  524. Fini
  525.